Closes a sound previously opened with _SoundOpen.
#include <Sound.au3>
_SoundClose ( $sSnd_id )
Parameters
| $sSnd_id | Sound ID (the 'alias') as returned by _SoundOpen |
Return Value
| Success: | 1 |
| Failure: | 0 |
| @Error: | 0 = No Error |
| 1 = Failure |
Remarks
None.
Related
_SoundOpen
Example
#include <Sound.au3>
;open sound file
$sound = _SoundOpen(@WindowsDir & "\media\Windows XP Startup.wav", "Startup")
If @error = 2 Then
MsgBox(0, "Error", "The file does not exist")
Exit
ElseIf @error = 3 Then
MsgBox(0, "Error", "The alias was invalid")
Exit
ElseIf @extended <> 0 Then
$extended = @extended ;assign because @extended will be set after DllCall
$stText = DllStructCreate("char[128]")
$errorstring = DllCall("winmm.dll","short","mciGetErrorStringA","str",$extended,"ptr",DllStructGetPtr($stText),"int",128)
MsgBox(0, "Error", "The open failed." & @CRLF & "Error Number: " & $extended & @CRLF & "Error Description: " & DllStructGetData($stText, 1) & @CRLF & "Please Note: The sound may still play correctly.")
Else
MsgBox(0, "Success", "The file opened successfully")
EndIf
If _SoundClose($sound) = 1 Then
MsgBox(0, "Success", "The sound was closed successfully")
Else
MsgBox(0, "Error", "The file was not closed successfully")
EndIf